revelplayer/com.reveldigital.player.api/[androidJvm]Controller/sendRemoteCommand

sendRemoteCommand

abstract fun sendRemoteCommand(@NonNull registrationKeys: Array<String>, @NonNull name: String, @Nullable arg: String)

Sends a command to one or more remote RevelDigital player devices.

This method allows the current player instance to instruct other devices, identified by their unique registrationKeys, to execute a specific command. The command is dispatched through the RevelDigital backend infrastructure.

Important:

  • Remote commands are typically only delivered to devices that are online and registered within the same account as the calling device.
  • Delivery is not guaranteed and may depend on network conditions and the state of the target devices.
  • There is no direct synchronous feedback on the success or failure of the command execution on the remote devices through this method call. Monitoring remote device state or using other mechanisms would be required to confirm command execution.

Parameters

registrationKeys

An array of non-null, unique registration keys identifying the target RevelDigital devices. Must not be null or empty, and should not contain null or empty strings.

name

The non-null, case-sensitive name of the command to send (e.g., "REFRESH_CONTENT", "SHOW_MESSAGE"). The available remote commands and their behavior are defined by the player system on the receiving devices.

arg

The argument for the command. This can be null if the command does not require one. The meaning and format of the argument are specific to the command name and how it's interpreted by the remote devices.

See also

For sending commands to the local player.

Throws

if registrationKeys or name is null, or if the registrationKeys array contains a null element.

if registrationKeys is empty, or if name is empty.